home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / sgi.lha / Geomview / INSTALL < prev    next >
Text File  |  1993-11-18  |  5KB  |  111 lines
  1.  
  2. NOTE: This file is autogenerated from the Geomview manual.
  3.   For references to things not in this file, see the manual.
  4.   The manual is distributed in the "doc" subdirectory.
  5.  
  6.  
  7. Installing the SGI Binary Distribution
  8. ======================================
  9.  
  10. If you have just obtained a copy of the SGI binary distribution (file
  11. `geomview-sgi.tar.Z'), you should be able to run Geomview and make
  12. use of most of its features immediately after unpacking it by
  13. `cd''ing to the directory that it is in and typing `geomview'.
  14.  
  15. In order to fully install Geomview so that you can run it from any
  16. directory and use all of its features, follow the steps in this section.
  17. In particular, you must go through this installation procedure in order
  18. to use Geomview to display Mathematica graphics.
  19.  
  20. Geomview is distributed in a directory that contains various files and
  21. subdirectories that Geomview needs at run-time, such as data files and
  22. external modules.  It also contains other things distributed with
  23. Geomview, such as documentation and (in the soure-code distribution)
  24. source-code.  We refer to the root directory of this tree as the
  25. `$GEOMROOT' directory.  This is the directory called `Geomview'
  26. that is created when you unpack the distribution file.
  27.  
  28. To install Geomview on your system, arrange for the `$GEOMROOT'
  29. directory to be in a permanent place.  Then, in a shell window,
  30. `cd' to that directory and type `install'.  This runs a shell
  31. script which does the installation after asking you several questions
  32. about where you want to install the various components of Geomview.
  33.  
  34. After running the `install' script you should now be able to run
  35. Geomview from any directory on your system.  (You may need to give the
  36. `rehash' command in any shells on your computer that were started
  37. up before you did the installation.)
  38.  
  39.  
  40. The `install' script puts copies of the files in
  41. `$GEOMROOT/bin/sgi' and `$GEOMROOT/man' into the directories
  42. you specified for executables and man pages, respectively.  Once you
  43. have done the installation you can cut down one the disk space required
  44. by Geomview by removing some files from these directories, since copies
  45. have been installed elsewhere.  You should first test that your
  46. installed Geomview works properly because once you remove these files
  47. from their distribution directories you will not be able to do the
  48. installation again.
  49.  
  50. In particular, the files you can remove are
  51.  
  52.  
  53. `$GEOMROOT/bin/sgi':
  54.      Remove all files from here except `gvx', which is the geomview
  55.      executable file.  DO NOT REMOVE `gvx'.  It is not installed
  56.      elsewhere.
  57.  
  58. `$GEOMROOT/man':
  59.      You can remove all the files in this directory.
  60.  
  61.  
  62.  
  63.  
  64. Details of the SGI Binary Installation
  65. --------------------------------------
  66.  
  67. The `install' script should be self-explanatory; just run it and
  68. answer the questions.  This section gives some details for system
  69. administrators and other users who may want to know more about the
  70. installation. 
  71.  
  72. The installation is actually done by `make'; the `install'
  73. script queries the user for the settings of the following `make'
  74. variables and then invokes `make install'.
  75.  
  76.  
  77. `GEOMROOT':
  78.      the absolute pathname of the Geomview root directory.  The
  79.      `geomview' shell script, which is what users invoke to run
  80.      Geomview, uses this to set various environment variables that Geomview
  81.      needs.  It is very important that this be an *absolute* pathname
  82.      --- i.e. it should start with a '/'.
  83.  
  84. `BINDIR':
  85.      a directory where executable files are installed.  The `geomview'
  86.      shell script goes here, as well as various other auxiliary programs that
  87.      can be used in conjunction with `geomview'.  This should be a
  88.      directory that is on users' `$path'.  These auxiliary programs are
  89.      distributed in the `$GEOMROOT/bin/sgi' directory; if you specify
  90.      this directory for `BINDIR', they are left in that directory.
  91.  
  92. `MANDIR':
  93.      a directory where Unix manual pages are installed.  These are
  94.      distributed in the `$GEOMROOT/man' subdirectory; if you specify
  95.      this directory for `MANDIR', they are left in that directory.
  96.  
  97. `MMAPACKAGEDIR':
  98.      a directory where Mathematica packages are installed.  This should be a
  99.      directory that Mathematica searches for packages that it loads; you can
  100.      see what directories your Mathematica searches by looking at the value
  101.      of the `$Path' variable in a Mathematica session.  The
  102.      installation process will install some packages there which allow you to
  103.      use Geomview to display Mathematica graphics.  These packages are
  104.      distributed in the `$GEOMROOT/mathematica' subdirectory; if you
  105.      specify this directory for `MMAPACKAGEDIR', or if you specify the
  106.      empty string for `MMAPACKAGEDIR', the packages are left in that
  107.      directory.  For more details about the way these Mathematica packages
  108.      connect to Geomview, *Note Package Installation::.
  109.  
  110.  
  111.